<?php

    #-------------------------------------------------------------#
	# This file is part of the Tekuna MVC Microframework for PHP. #
	# (c) 2009 Niels Jäckel <niels.jaeckel@tekuna.org>            #
	# Please visit http://tekuna.org/ for more information.       #
	#                                                             #
	# This software is licensed under the MIT License. Please     #
	# view the LICENSE file for the full text of this license.    #
    #-------------------------------------------------------------#


	Tekuna :: load('org.tekuna.core.application.TekunaApplicationContext');


	/**
	 * Interface for a language chooser. This application fragment decides which
	 * language will be used for the application execution. The necessary information
	 * are taken from the given application context.
	 */

	interface TekunaLanguageChooser {


		/**
		 * Constructor for a new language chooser.
		 *
		 * @param TekunaApplicationContext $objContext the context object
		 */

		public function __construct(TekunaApplicationContext $objContext);


		/**
		 * This method implements the actual decision logic and returns a
		 * language string.
		 *
		 * @return string the selected language
		 */

		public function chooseLanguage();
	}
